home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 1
/
Cream of the Crop 1.iso
/
MONITOR
/
VMOIRE18.ARJ
/
VGAMOIRE.DOC
< prev
Wrap
Text File
|
1992-03-30
|
50KB
|
1,060 lines
════════════════════════════════════════════════════════════════
VGAMOIRE v1.8
by Christopher Antos
Copyright (C) 1990,1991 by Christopher Antos
March 1992
moi│re (mwär, môr) n. [Fr, watered silk < MOHAIR] a
fabric, esp. silk, rayon, or acetate, having a
watered, or wavy, pattern.
_ _
moi│ré (mwär ra', mô-; môr'a) adj. [Fr, pp. of /moirer/,
to water < /moire/: see prec.] having a watered, or
wavy, pattern, as certain fabrics, stamps, or metal
surfaces --n. 1 a watered pattern pressed into
cloth, etc. with engraved rollers 2 MOIRE
─── From Webster's New World Dictionary, Third College
Edition, Copyright (C) 1988 by Simon & Schuster, Inc.
════════════════════════════════════════════════════════════════
Questions or Comments?
Please write to: Christopher Antos
2115 Windsor Drive
Ann Arbor, Michigan
48103-5652
Or send EMail to "Christopher_Antos@um.cc.umich.edu"
or "antos@engin.umich.edu"
════════════════════════════════════════════════════════════════
Please write and make suggestions, complaints, compliments, or
even ask questions. Thank you!
─────── CONTENTS ───────────────────────────────────────────────
Registering VGAMoire
Release Notes
Introduction
Installing VGAMoire
Using VGAMoire's Features
Uninstalling VGAMoire
Examples
Known Conflicts
Version History Summary
────────────────────────────────────────────────────────────────
═══════ REGISTERING VGAMOIRE ═══════════════════════════════════
This program is not free, nor is it in the Public Domain. It is
a ShareWare program. This means that you can try it out for a
reasonable length of time. If it useful to you, or you like it,
you must register it. To do this, print out the file
REGISTER.TXT and follow the instructions within it.
VGAMoire is a very high quality screen saver. If you can find a
better one for a lower price, I'd like to know (seriously!). It
has features the commercial competition can't even claim to
match. I put a lot of time and energy into this product, and I
believe anyone with a VGA graphics adapter cannot help but
benefit from using VGAMoire.
So, please fill out the registration form (in REGISTER.TXT) and
register today! You will be notified of any future releases
when they are made available.
═══════ RELEASE NOTES ══════════════════════════════════════════
I am preparing to release a new, vastly improved version (and
rewritten nearly from scratch) of this screen saver. The new
product is called Morning Star and uses "saver modules". A
saver module is a small program which draws a particular design.
Morning Star lets you choose which saver module to use. It can
even switch randomly between different saver modules, adding
some sparkle to the screen. Because Morning Star uses a very
large amount of memory, it unfortunately requires EMS memory.
This allows it to keep all of its data in EMS memory and only
use less than 8k of conventional memory, to avoid interfering
with other applications. Morning Star will also support
multiple video cards. However, the first release will probably
only include a VGA video driver. Later updates will provide
support for other video cards.
If you have a third-party (non-IBM) SuperVGA adapter, please see
the "Known Conflicts" section for information on a possible
problem between VGAMoire and your video adapter card. This
release, VGAMoire v1.8, provides solutions to many of the
problems caused by bugs in the Tseng Labs VGA chip. The fixes
will allow VGAMoire to work much better on almost all VGA
displays, whether IBM, ATi, Tseng Labs, or another manufacturer.
═══════ INTRODUCTION ═══════════════════════════════════════════
You've probably seen a lot of other screen savers, and you're
probably not very impressed. Many are boring and just blank out
the screen--which can even be annoying, because sometimes it's
hard to tell if the machine or the monitor are even on! Other
screen savers may save the display in memory and draw a moving
design until a key is pressed. I have yet to see any other
screen saver that saves the FULL display configuration and
restores it. Other popular screen savers have a number of tiny
but very annoying flaws (eg, they might not save the cursor
shape, maybe they don't hide the mouse pointer or save the mouse
driver state, perhaps they can't use EMS, they may only save up
to four video pages, they probably can't restore the screen
properly unless it is in 25-line text mode, etc...)
I decided it was time to write a screen saver that restored the
screen COMPLETELY. Enter VGAMoire. The moire pattern design
was inspired by Magic! (for Microsoft Windows) and Moire (for
the Macintosh), two other well-known screen savers. VGAMoire
has enjoyed a large amount of success, but many users suggested
other designs and support for video cards besides VGA. During
the past year, I've been hard at work on Morning Star, a new,
much improved version of VGAMoire (I had to change the name
because Morning Star can do other designs besides the moire, and
because Morning Star works on video cards besides the VGA).
Morning Star is not yet ready to be released, but it's getting
close!
Summary of Features:
~~~~~~~~~~~~~~~~~~~
o can use EMS memory, if any is available!
o allows options to be changed while it is resident!
o is Windows-aware!
o is mouse-aware!
o can wait up to 30 minutes, then activate!
o is telecommunications-aware!
o is disk-I/O-aware!
o can be turned on/off from the keyboard or batch
files!
o certain aspects of the moire design can be
configured by the user!
o will not interfere with DOS!
o is DESQview compatible!
═══════ INSTALLING VGAMOIRE ════════════════════════════════════
NOTE: If at any time you have trouble with VGAMoire,
first check in the "Known Conflicts" section to
see if your problem is described there!
You can install VGAMoire from the DOS prompt, or from your
AUTOEXEC.BAT file.
Once VGAMoire is installed, you can pop up the screen saver
manually by pressing the hotkey (the default is Ctrl-Alt-Shift),
or you can let the machine idle for the specified amount of time
and let the screen saver automatically pop up. You can press
Ctrl-Alt-E to disable the screen saver (though you can still
manually pop it up). Pressing Ctrl-Alt-B will reenable the
screen saver.
NOTE: some SuperVGA cards have extended text modes (eg.
100, 120, 132 columns as opposed to just 80).
Some cards are not fully IBM compatible in these
extended text modes, so for compatibility's sake,
VGAMoire only blanks the screen in these modes
(just as it does in graphics modes).
VGAMoire will not become resident unless you specify how many
minutes it should wait before popping up. This allows you to
try out different options without actually installing VGAMoire.
VGAMoire also checks to see whether it has already been
installed. If it has, it will display an error message and will
not load a second copy into memory. This prevents you from
accidentally wasting memory.
To install VGAMoire (without specifying any options), type:
VGAMOIRE W<n>
where <n> is the number of minutes to count down before popping
up. If you do not use the [Wn] option, VGAMoire will generate
its moire design until you press a key or move the mouse. It
will not install itself in memory, though.
VGAMoire will pop up after the computer has sat idling for the
specified number of minutes. You can force it to pop up on
demand by pressing the Ctrl, Alt, and Shift keys together (you
only need to use one Shift key, and it can be either one). This
Ctrl-Alt-Shift hotkey works regardless of whether VGAMoire has
been turned off or not. This feature exists so that you can
still manually pop up the screen saver if you have disabled
VGAMoire (presumably because its "safety detection" methods do
not work reliably in conjunction with a particular application).
You can also instruct VGAMoire to use a different hotkey than
the Ctrl-Alt-Shift combination. See the [Kc] option for more
information on using your own hotkey.
NOTE: VGAMoire should not be loaded above any
application programs. In other words, the
computer may have a heart attack if you load
VGAMoire (or any memory-resident utility, for
that matter) from a DOS shell.
MEMORY USAGE ───────────────────────────────────────────────────
VGAMoire can use different kinds of memory in different ways.
When you install VGAMoire, it will take slightly under 5k of
conventional memory, where the main screen saver code resides,
plus an amount of memory which depends upon which installation
options are given.
If you have EMS memory and choose to use it, VGAMoire will only
take 5k of conventional DOS memory and will store all of its
data in EMS memory. The data is between 16k and 112k in size,
depending on how you configure VGAMoire.
If EMS memory is NOT used (ie, if only conventional memory is
utilized), then VGAMoire will store its data in conventional
memory. The data is between 16k and 112k in size, depending on
how VGAMoire is configured. It is a good idea to use EMS memory
if possible, or at least to minimize the amount of conventional
DOS memory that VGAMoire uses.
If you are really tight on memory and just want a simple but
intelligent screen blanker, the you can use the [B1] and [O0]
(that's an uppercase "O" and a zero) options together. This
will make VGAMoire only use slightly under 4k of conventional
DOS memory, but it will not be able to draw the moire design.
═══════ USING VGAMOIRE'S FEATURES ══════════════════════════════
To see a list of the command line options that VGAMoire accepts,
you can type:
VGAMOIRE ?
at the DOS prompt. The list will look like this:
┌──────────────────────────────────────────────────────────────────────────────┐
│ VGAMoire 1.8, by Christopher Antos, March 1992, (C)1990-1992 │
│ │
│ Syntax: VGAMOIRE [ options ] │
│ Options must be separated by spaces, slashes, or tabs. │
│ │
│ Summary of options: * = invalid if used with [N] │
│ Bn blank: 0=graphics, 1=always Pn save <n> video pages [1..8] │
│ Cn color sets: [1..5] Rn mirror: 0=none,1=horiz,2=vert,│
│ Dn delay: [0..255] 3=horiz+vert,4=diagonal │
│ E * use EMS Sn color speed: [1..255] │
│ Fn save <n> font blocks [0..8] U uninstall │
│ Kc hotkey Vn video: 0=ignore, 1=monitor │
│ Ln lines: [1..50] Wn wait <n> minutes [1..30] │
│ Mn mouse: 0=ignore, 1=monitor Zc COM ports to monitor │
│ N send options to resident copy - turn off │
│ On fadeout: 0=don't, 1=fade + turn on │
└──────────────────────────────────────────────────────────────────────────────┘
When installing VGAMoire, you can specify any of these
parameters to customize how VGAMoire behaves. Each will be
discussed separately, along with some tips and tricks on
combining certain options (any of the options may be used with
any of the other options, except as noted).
To use an option, specify it on the command line. Be sure to
put a space between different options, and do NOT put a space
between an option letter and the value you are setting it to. Do
not type the brackets that are used in the documentation. They
are only used to easily distinguish options from other text.
Correct: VGAMOIRE C1 M1
Wrong: VGAMOIRE C1M1
Wrong: VGAMOIRE C 1 M 1
─── THE OPTIONS ────────────────────────────────────────────────
[Bn] If VGAMoire times out while the display is in a graphics
mode, VGAMoire will just blank the screen and allow the
current application to continue processing. As soon as
any key is pressed or the mouse is moved, VGAMoire will
restore the screen. If you want VGAMoire to do this
with text screens, too, instead of drawing the moire
design, you can use this option. Example:
VGAMOIRE B1
This tells VGAMoire to always blank the screen instead
of drawing the moire design. To allow VGAMoire to draw
the design again, use B0 instead of B1.
SPECIAL NOTE: If VGAMoire is installed with both the B1 and O0
options, it will only take about 4k of conventional DOS
memory. If it is installed with B1 but not with O0,
then it will take 4.7k. This way, you can force it to
be a real memory miser, in case you are really low on
memory or don't have EMS. It will not allocate any
memory -- neither conventional nor EMS (not even if the
[E] option is used) -- for a save buffer, and it will
not be able to draw the moire design at all unless it is
uninstalled and reinstalled without the B1 option.
[Cn] VGAMoire has several different color sets it can use.
VGAMoire reprograms the VGA's color registers to produce
non-standard colors, thus giving truer, better, and more
colors than otherwise possible. Example:
VGAMOIRE C3
This would tell VGAMoire to use "frosty" colors to draw
the moire pattern. Below is a list of possible color
sets:
C1 - Rainbow
C2 - Fire
C3 - Frost
C4 - Pastel
C5 - Glowing red
[Dn] VGAMoire is a very fast program because it uses highly
optimized assembly language routines (the whole program
is written in assembly language) to directly access the
VGA hardware, instead of using ROM BIOS function calls
to do the job. On most computers that have VGA cards
(except maybe some slow ATs or XTs), you will want to
slow down the design. You can specify a delay value in
the range of 0 (fast) to 255 (very slow). Example:
VGAMOIRE D35
On 16MHz PS/2 Model 70's, a good delay value to use is
usually about 35 or 40, but of course it depends on your
taste.
[E] If you have EMS memory, you can tell VGAMoire to make
good use of it. VGAMoire will store all of its data in
EMS memory, leaving much more RAM free for your normal
DOS applications. VGAMoire is compatible with EMS 3.1
and higher (it even names its EMS handle under EMS 4.0
and higher). Example:
VGAMOIRE E
Note that the [E] option cannot be used with the [N]
option (which will be explained later). Also note that
VGAMoire reserves the total amount of EMS that it will
use AT THE TIME IT IS INSTALLED. To stop using EMS, you
must uninstall VGAMoire and then reinstall it.
[Fn] This option tells VGAMoire to save and restore the VGA
character generator RAM and the complete video state.
You can specify how many font blocks to save and restore
(from 0 to 8). If you need this feature at all, saving
just one font block will generally be enough. Example:
VGAMOIRE F1
Using this feature allows VGAMoire to correctly save and
restore even such non-standard video modes as 60-line
displays or 33-line displays. Otherwise, VGAMoire can
save all the information except the current character
fonts and the screen size (changing the screen size
requires loading an alternate font, so the two are
really inseparable). Saving fonts is a real memory
guzzler, and I recommend only saving one font block, if
any.
If you are using EMS memory, you can change the number
of font blocks to save by using the [Fn] option with the
[N] option.
[Kc] This option allows you to set your own hotkey to pop up
the screen saver. You can use any combination of the
Alt/Ctrl/Shift keys and one "normal" key. You can set
it to distinguish between the left and right Shift keys,
or you can have it treat them the same.
The syntax of this option is very simple. First, of
course, comes the "K". After the "K", just type the
names of the keys you want to use, surrounding each
key's name with squigly brackets ("{}"). Examples:
1) VGAMOIRE K{CTRL}{RIGHTSHIFT}{S}
This instructs VGAMoire to use Ctrl-RightShift-S
as the hotkey.
2) VGAMOIRE K{ALT}{SHIFT}
This tells VGAMoire to use the Alt key and
either of the two Shift keys as the hotkey.
3) VGAMOIRE K{CTRL}{F12}
This sets Ctrl-F12 as the hotkey.
It is also possible to completely disable the hotkey:
VGAMOIRE K
This disables the hotkey, so that it is impossible to
manually pop up the screen saver. To reenable the
hotkey, just select a different hotkey.
──── LIST OF VALID KEYS ────────────────────────────────
{ALT} - the Alt key
{CTRL} - the Ctrl key
{LEFTSHIFT} - the left Shift key
{RIGHTSHIFT} - the right Shift key
{SHIFT} - either Shift key
──── LIST OF VALID "NORMAL" KEYS ───────────────────────
{A}..{Z} - the letter keys
{F1}..{F12} - the function keys
{0}..{9} - number keys (NOT the numeric keypad!)
NOTE: if you forget what the current hotkey is,
just type "VGAMOIRE ?" at the DOS prompt,
and if VGAMoire has been installed yet,
it will tell you what the current hotkey
is.
[Ln] You can make the moire pattern have up to 50 lines in
it. The default is 25 lines. Example:
VGAMOIRE L40
This would make VGAMoire generate a 40 line moire
pattern. You must tell VGAMoire to use at least one
line (any less wouldn't really make much sense, now
would it?).
[Mn] If you are experiencing trouble and either do not have a
mouse, or have an old mouse driver, try using this
feature before giving up. This determines whether or
not VGAMoire monitor the mouse hardware for activity (by
default, VGAMoire will constantly monitor the mouse for
any activity and restart the countdown if it detects
any). Example:
VGAMOIRE M0
This tells VGAMoire to ignore any mouse activity
(VGAMoire simply doesn't bother to monitor the mouse at
all). To tell VGAMoire to resume monitoring the mouse,
you can use M1 instead of M0.
[On] VGAMoire can make the screen fade to black before
drawing the design (or when blanking the screen). The
current application can even continue processing while
the screen is fading out. You can configure it not to,
though, if you wish. Example:
VGAMOIRE O0
This tells VGAMoire not to make the screen fade out.
You can tell VGAMoire to re-enable screen fading by
using the O1 option (the default setting). Note that if
VGAMoire detects any activity while it is dimming the
screen, it will restore the palette and will not blank
the screen or draw the design.
[Pn] The VGA card has 8 video text pages, although DOS and
most of the IBM programs only use page 0 (some programs
draw screens on other pages and then transfer them to
page 0 to make it seem as though they are drawing the
display at lightning speeds). You can use the [Pn]
option to indicate how many video pages you wish to
save. VGAMoire saves however many pages you tell it to,
starting with page zero (the pages are numbered 0
through 7). If you use the 50-line mode ever, you
should probably save at least 2 pages. Example:
VGAMOIRE P2
This tells VGAMoire to save 2 video pages when it
switches to graphics mode to draw the moire pattern.
This option can be used with the [N] option if you are
using Expanded Memory (see the [E] option). Otherwise,
to change the number of video pages that are saved, you
must uninstall VGAMoire and then reinstall it.
NOTE: if you use the NNANSI.SYS display driver
(or certain other "improved ANSI display
drivers"), you should be aware that it
can scroll the screen at a very high
speed by modifying the starting location
of the screen display buffer. If you use
this feature of your display driver, you
should either tell VGAMoire to save all 8
video pages or tell your display driver
to scroll text the "old-fashioned way".
NOTE: if you use a program that allows more
than 25 lines on the screen, you should
save at least two video pages, and if you
use a program which allows more than 50
lines, you need to save at least 3 video
pages.
[Rn] This controls how VGAMoire mirrors the pattern. By
default, VGAMoire doesn't mirror it at all. You can
instruct the screen saver to mirror the design
horizontally, vertically, both horizontally and
vertically together, or diagonally. Example:
VGAMOIRE R2
This would cause VGAMoire to mirror the pattern
vertically (top-to-bottom). Use [R0] to not mirror at
all, [R1] to mirror horizontally, [R2] to mirror
vertically, [R3] to mirror both horizontally and
vertically together, or [R4] to mirror diagonally.
[Sn] By default, VGAMoire changes colors each time it draws a
new line. If you're using a large number of lines, or
if the colors are changing more quickly than you'd like,
you can make them change slower. Example:
VGAMOIRE S3
This would make VGAMoire change colors after every third
line. You can use any number in the range 1 to 255. If
you were using only 5 lines, and you wanted it to look
like the pattern were slowly glowing, you might use a
value of 10 or 12 with the [Sn] option.
[U] This lets you uninstall VGAMoire. Please see the
section "Uninstalling VGAMoire" for more information.
[Vn] Some programs which use the video BIOS to write to the
screen may confuse VGAMoire into never timing out. If
this happens, you can use this option to force VGAMoire
to ignore video activity. Example:
VGAMOIRE V0
This tells VGAMoire to ignore any video activity. To
make VGAMoire resume watching for video activity, use V1
instead of V0.
[Wn] As I demonstrated in the "Installation" section, you can
specify a number of minutes to count down (Wait) before
popping up the moire pattern. VGAMoire can count down
anywhere from 1 to 30 minutes. Example:
VGAMOIRE W4
This instructs the screen saver to count down four
minutes before taking over and drawing the moire
pattern. Remember: if you do not specify a number of
minutes to count down (it must be a valid value to be
recognized), VGAMoire will not become resident but will
display its pattern until you press a key or move the
mouse.
[Zc] VGAMoire can now monitor the COM ports directly for
activity! If the Carrier Detect signal (for
telecommunications) is present, VGAMoire will only blank
the screen (allowing the telecommunications program to
keep processing in the background). If the Carrier is
lost (or is just acquired), then VGAMoire will restore
the screen. In addition, VGAMoire will flash the border
color when the phone rings (provided you have a modem
attached to your computer and the phone line)! I find
this quite useful, because sometimes I wear headphones
and can't hear the phone ring.
You can tell VGAMoire which COM ports to monitor by
using the [Zc] option. To turn off COM port monitoring,
use Z0:
VGAMOIRE Z0
To specify a port(s) to monitor, give the port numbers:
VGAMOIRE Z12
This would monitor COM1 and COM2 for activity. If you
want to turn off monitoring for a specific port, put a
minus sign before its number:
VGAMOIRE Z-1
This would turn off monitoring for COM1, but would not
affect monitoring for other COM ports.
[N] Once VGAMoire is resident, you cannot switch back and
forth between using EMS memory or conventional memory
(the [E] option). To switch, you must uninstall and
then reinstall VGAMoire. However, any of the other
options may be changed even once VGAMoire is resident.
To change them, just use the [N] option somewhere on the
command line. Example:
VGAMOIRE W2 N D30
This changes the number of minutes that VGAMoire counts
down before popping up to 2 minutes, and changes the
delay value to 30. No other options are changed.
[-] VGAMoire can be disabled from DOS with the [-] option.
This allows batch files to turn off VGAMoire and then
later turn it back on. Examples:
1) VGAMOIRE - N
This turns the RESIDENT COPY of VGAMoire off
(because the [N] option is used along with the
[-] option).
2) VGAMOIRE - W4
This would install VGAMoire and set the
countdown at four minutes, but would also turn
VGAMoire off as it was being installed. For
VGAMoire to be able to pop up, it would have to
be later turned on, which we will discuss next.
[+] To turn VGAMoire back on, use this command:
VGAMOIRE + N
This turns the RESIDENT COPY of VGAMoire on (because the
[N] option is used with the [+] option). Using the [+]
makes no sense unless the [N] option is used also,
because VGAMoire defaults to being "on". You don't need
to do anything to install VGAMoire as "on".
NOTE: the [-] and [+] options maintain a
counter, so they may successfully be
nested within batch files.
═══════ UNINSTALLING VGAMOIRE ══════════════════════════════════
VGAMoire can uninstall itself and give both conventional and EMS
memory it was using back to DOS. Example:
VGAMOIRE U
The [U] option, just like any of the other options, can be used
from the DOS prompt or from in a batch file. If another program
has taken over the interrupt vectors that VGAMoire captured,
then VGAMoire will tell you and ask if you really want to
uninstall it. You can press 'N', 'Y', or ESC. If you hit 'N' or
ESC, VGAMoire will print a message saying that it is still
installed. If you choose to uninstall it anyway, VGAMoire will
try to uninstall itself. This may result in a system crash,
depending on what is loaded above VGAMoire. You can allow
VGAMoire to uninstall itself cleanly by uninstalling whatever is
in memory above it first. If the system does crash, just reboot
(or turn the computer off). Note that the system may not crash
immediately.
═══════ EXAMPLES ═══════════════════════════════════════════════
Here are some examples for installing VGAMoire:
VGAMOIRE W4 P8 E F8 D40 S3 C1 L50 R3
This tells VGAMoire to become resident and count down four
minutes before popping up. It will save all eight video pages
in EMS memory, and will also save all eight character generator
RAM blocks. The delay to slow down the moire pattern is set to
40 (the delay value is not an absolute measure of time, but
rather is relative to CPU speed). VGAMoire will change color
every three lines, use rainbow colors, and will draw a moire
pattern consisting of 50 lines. Finally, it will mirror both
horizontally and vertically. This could be called the "full
featured" installation, because it makes use of each of the
special VGAMoire options. It also uses the least conventional
memory (3.8k) and the most EMS memory (112k).
A less impressive configuration might be this:
VGAMOIRE W4 P2 S3 C1 L20 D50
This would again count down four minutes, but only save two
video pages. It would not use EMS memory, so it would take a
total of about 12.8k of conventional memory. It would change
color every third line, use rainbow colors, and only draw 20
lines in the moire pattern. It would use a delay value of 50
(again, the delay is arbitrarily relative to the CPU speed and
follows a roughly linear graph of speed decrease as the delay
value increases).
Following is a sample batch file to disable VGAMoire before
executing an application and then reenable it when the
application returns to DOS:
APP1.BAT
──────────────────────────────────────────────
@ECHO OFF
\TOOLS\VGAMOIRE N - >NUL
CD\[GAME_DIR]
[GAME]
\TOOLS\VGAMOIRE N + >NUL
Following is a sample batch file to make VGAMoire just blank the
screen (instead of drawing the moire design) and allow the
program to continue operating in the background (the screen will
come back if any activity is detected--mouse, keyboard, disk,
etc. The batch file then executes an application. When the
application is done, VGAMoire is reset so that it will draw the
moire design again:
APPBLANK.BAT
──────────────────────────────────────────────
@ECHO OFF
\TOOLS\VGAMOIRE N B0 >NUL
CD\[APP_DIR]
[APPLICATION]
\TOOLS\VGAMOIRE N B1 >NUL
═══════ KNOWN CONFLICTS ════════════════════════════════════════
─── TELECOMMUNICATIONS ─────────────────────────────────────────
It is reported that ProComm PLUS 2.0 has difficultly coexisting
with VGAMoire. We do not currently have any way to make them
coexist. VGAMoire recognizes when a modem has a CARRIER signal,
but is cannot detect if a terminal program is auto-redialing.
Use the previous sample batch file (APPBLANK.BAT) to run your
telecommunication program, so that VGAMoire will only blank the
screen and not suspend telecommunications by drawing the moire
design.
─── DOS 4.0 and 5.0 ────────────────────────────────────────────
To use VGAMoire with the DOSSHELL menu program, you will have to
do one of two things. If your AUTOEXEC.BAT or CONFIG.SYS file
loads a mouse driver into memory, then you can edit the
DOSSHELL.BAT file and make VGAMoire work with it perfectly
(instructions are given below). If you do not load a mouse
driver into memory, but still want to use the mouse in DOSSHELL,
then you have no choice but to configure VGAMoire not to monitor
the mouse, otherwise DOSSHELL will have severe trouble
responding when you press the mouse button. Aside from this,
VGAMoire is fully compatible with DOS 4.0 and 5.0.
If you load a mouse driver into memory before using DOSSHELL,
then you can simply edit one line in your DOSSHELL.BAT file to
let DOSSHELL know this. By default, DOSSHELL uses its own mouse
driver, which is incompatible with the software standard for
mouse drivers (I don't understand why Microsoft/IBM did it this
way--it seems pretty stupid, to me). What you need to do is use
a file editor (eg: QEdit, EMacs, VEDIT, or even EDLIN) to modify
the line that begins with "@SHELLC" (it will probably be a very
long line). Find where it says "/MOS:xxxxxxxx.DRV" and just
remove that part of the line (the xxxxxxxx's may vary depending
on your system). This tells DOSSHELL that you have your own
mouse driver installed, and that it should make use of it.
For example, this is the DOSSHELL.BAT file that the DOS 4.0
installation program created for me on my IBM PS/2 Model 70:
@SHELLB DOSSHELL
@IF ERRORLEVEL 255 GOTO END
:COMMON
@BREAK=OFF
@SHELLC /MOS:PCIBMDRV.MOS/TRAN/COLOR/DOS/MENU/MUL/SND...
.../MEU:SHELL.MEU/CLR:SHELL.CLR/PROMPT/MAINT...
.../EXIT/SWAP/DATE
:END
@BREAK=ON
To make VGAMoire work with DOSSHELL, delete the part that says
"/MOS:....MOS" so that it looks like this:
@SHELLB DOSSHELL
@IF ERRORLEVEL 255 GOTO END
:COMMON
@BREAK=OFF
@SHELLC /TRAN/COLOR/DOS/MENU/MUL/SND/MEU:SHELL.MEU...
.../CLR:SHELL.CLR/PROMPT/MAINT/EXIT/SWAP/DATE
:END
@BREAK=ON
─── GAMES ──────────────────────────────────────────────────────
Many commercial games are not "well-behaved" programs, in that
they take over certain parts of the operating system and just
don't respect other programs. With some games, VGAMoire might
work perfectly, but with most it won't. Usually, if the screen
blanks while you are playing a game, you can try either hitting
one of the Shift keys or moving the mouse. If this does not
restore the screen, you may have to reboot.
For games that VGAMoire doesn't get along well with, you should
disable VGAMoire before starting the game (see the "APP1.BAT"
example in the "Examples" section). You can also manually
disable VGAMoire before playing the game by using the Ctrl-Alt-E
hotkey. Press Ctrl-Alt-B after you have finished with the game,
to reenable VGAMoire.
─── MICE ───────────────────────────────────────────────────────
VGAMoire is only mouse-sensitive with Microsoft-compatible mice;
it cannot recognize Mouse Systems mice unless they are in
Microsoft emulation mode (Logitech and most other popular mice
should work fine--if the mouse has a Microsoft emulation mode,
make sure you are using it, though).
─── MICROSOFT WORD ─────────────────────────────────────────────
VGAMoire works fine with Microsoft Word, but with some SVGA
video cards, the screen may be restored with blinking text on
it. This is a problem with some SVGA cards, and is not
VGAMoire's fault, but we're looking for a solution.
─── SUPER-VGA ADAPTERS ─────────────────────────────────────────
Some SVGA video cards (especially those based on the Tseng Labs
chip) are NOT fully 100% IBM VGA compatible, even though they
may claim to be. VGAMoire tries its best to work correctly on
such cards, but there may be some minor problems in restoring
the screen after drawing the moire design. Some cards may not
be able to blank the screen, either.
─── MULTITASKING SYSTEMS ───────────────────────────────────────
(such as DESQview, TopView, VM/386)
Multitasking is hard to accomplish, and some multitasking
systems will be able to run VGAMoire while others will not. If
your system is not described below, you will have to determine
if VGAMoire can be run and, if so, how it must be configured.
DESQview - VGAMoire is compatible with DESQview. HOWEVER, YOU
MUST SET IT TO ALWAYS DO SCREEN BLANKING AND TO
IGNORE THE MOUSE, which you do by using the B0 and
M0 options (take a look at the "APPBLANK.BAT" batch
file in the "Examples" section).
TopView - We have not had the opportunity to test VGAMoire
with TopView, but we believe it will behave under
TopView the same way as under DESQview. On that
assumption, you should follow the directions for
DESQview (outlined above) for TopView, DESQview,
and any other similar multitasking software.
VM/386 - VM/386 works on a different principle than most
other multitasking systems. VGAMoire works
perfectly with VM/386, but you must install
VGAMoire in each virtual machine that you want a
screen saver to be active in. So, if you have four
VMs running, you will need to install VGAMoire in
each of the four VMs. You should NOT install
VGAMoire before starting VM/386; install it in the
VMs, not in the VM Manager! (This holds true for
nearly any TSR program with VM/386).
─── PRINT SPOOLERS ─────────────────────────────────────────────
(or some programs taking a long time to print)
You may experience problems with VGAMoire when using a print
spooler (such as DMP or DOS PRINT). VGAMoire may take over
while the spooler is sending data to the printer (depending on
how it sends the data). The spooler should resume without any
complications as soon as VGAMoire returns control to the current
program (if you experience problems, be sure to let me know, so
I can work on fixing them!). If you want your spooler to be
able to print data even once VGAMoire decides to activate
itself, then you must use the [B1] option (see the description
of the [Bn] option for more information). Otherwise, printing
will resume when VGAMoire is done drawing its moire pattern.
═══════ VERSION HISTORY SUMMARY ════════════════════════════════
─── v1.0 ─────────────────────────────────────────── 7/14/90 ───
* Original version.
─── v1.1 ──────────────────────────────────────────── 8/2/90 ───
* Deallocates the environment block to conserve memory.
* Support added to save/restore RAM fonts (w/EMS only).
* Mirroring feature added.
* Improved mouse sensitivity.
>>> Possible bug if no mouse driver was installed--fixed.
>>> Bug where keyboard locked up if no EMS memory
used--fixed.
* Only keeps one color set resident--saves memory.
* Frost colors added.
─── v1.2 ──────────────────────────────────────────── 8/7/90 ───
* Blanks the screen while changing modes, to avoid ugly
screen flicker.
* Now makes sure color register 0 (black) is really set
to black.
>>> Bug in restoring fonts made us never restore
fonts--fixed.
─── v1.3 ─────────────────────────────────────────── 8/13/90 ───
>>> The [N] option got broken in v1.2--now fixed.
─── v1.4 ──────────────────────────────────────────── 9/4/90 ───
* Better mouse state save/restore.
* Better sensitivity to keyboard and mouse.
* Graphics mode blanking added.
─── v1.4b ────────────────────────────────────────── 9/21/90 ───
* Source code reorganized so I can try adding support
for other video cards (no guarantees...).
* Improved video state save/restore.
>>> EMS-related bug fixed.
─── v1.5 ──────────────────────────────────────────── 1/3/91 ───
* Increased stability due to improved interrupt
monitoring and stack context switching.
* Now DESQview compatible!
* [-] and [+] options now maintain a counter.
* The popup hotkey works even if VGAMoire is
turned off.
* Glowing red colors added.
* Can make the screen fade to black.
* Can deallocate itself even from High RAM.
* Now has diagonal mirroring feature.
* Can select a custom hotkey.
* The parameters have been slightly changed.
* No longer beeps if it can't pop up (beeping could
cause a system crash under certain conditions).
>>> Using our own stack fixed some "mysterious" crash
bugs.
>>> Screen blanking bug fixed (sometimes crashed after
restoring the screen).
>>> [Mn] option was reversed, now works right.
─── v1.6i ────────────────────────────────────────── 4/18/91 ───
* Telecommunications support added:
o Monitors Carrier signal on given COM ports.
o If CD is present, only blanks screen.
o If CD is present, ignores disk and video
activity.
* If VGAMoire is off hotkey is hit, only blanks the
screen.
* Border color flashes when phone rings (if a modem is
connected).
* The moire pattern fades in, too.
>>> Bug fix: custom hotkeys only worked right if they
were limited to combinations of Ctrl, Alt, and the
Shift keys.
>>> Bug fix: fixed problem which could cause potential
DOS instability and eventual crash.
─── v1.6TL ───────────────────────────────────────── 8/16/91 ───
* Better support added for VGAs which aren't 100% IBM
VGA compatible.
* Font blocks can now be saved in conventional memory,
as well as EMS memory.
─── v1.7 ─────────────────────────────────────────── 3/19/92 ───
* Now disables itself while Windows is running!
─── v1.8 ─────────────────────────────────────────── 3/30/92 ───
* OOPS! Sorry, everyone. Version 1.7 had a bug
which made it lock up as soon as you installed
it. Thousands of apologies!!
════════════════════════════════════════════════════════════════
I hope you find VGAMoire useful. Thank you for your support.
Christopher Antos
════════════════════════════════════════════════════════════════
